home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfsfcom.zip / SFSF.TXT < prev    next >
Text File  |  1990-09-23  |  15KB  |  449 lines
  1.  
  2.  
  3. -------------------------------------------------------------------------------------
  4.                             SFSFCOM V3 from Bob Zimmerman
  5. -------------------------------------------------------------------------------------
  6.  
  7.  
  8.  
  9.             (   A history  of versions  changes are  in the back of this
  10.             doc! )
  11.  
  12.  
  13.             If you  ever need to create a file for a "one time download"
  14.             for a  user, and then you delete it from the system, SFSFCOM
  15.             is for you!
  16.  
  17.             SFSFCOM was  created to  supplement  Spitfire's  File  Menu.
  18.             There are  times I  would like to make a file available to a
  19.             user for  downloading. I  only want  one or two people to be
  20.             able to download it.
  21.  
  22.             After they  download  their  files,  I  want  the  files  to
  23.             automatically be deleted.
  24.  
  25.             I sell software. If you register some of my software, I will
  26.             create a  special copy  of it for you. I would like ONLY YOU
  27.             to be able to download the file. When you have, I would like
  28.             to delete it to regain disk space.
  29.  
  30.             SFSFCOM does all of this automatically.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                      - Page 1 -
  66.  
  67. -------------------------------------------------------------------------------------
  68.                             SFSFCOM V3 from Bob Zimmerman
  69. -------------------------------------------------------------------------------------
  70.  
  71.  
  72.  
  73.             Installation:
  74.             -------------
  75.  
  76.  
  77.             Step 1    Create a directory for SFSFCOM. For the sake of
  78.                       example, let us say that we create a directory
  79.                       called  D:\SFSFCOM.
  80.  
  81.             Step 2    UNZIP file SFSFCOM.ZIP into your new directory.
  82.                       The file SFSFCOM is the door program. The SFSFADD
  83.                       is a utility program. SFSF.DAT will automatically
  84.                       be created for you, if it does not already exist.
  85.  
  86.             Step 3    You may install SFSFCOM on the doors menu, from
  87.                       Wildfire, from the SFMNUEXT menu, or from the
  88.                       Sysop Configurable. I will discuss installing it
  89.                       from the Sysop Configurable (option K) of the File
  90.                       Menu.
  91.  
  92.                       To install on the File Menu as option "K":
  93.                       ------------------------------------------
  94.  
  95.                            Create SFFILE.BAT in your Spitfire Directory
  96.                            (as the Spitfire manual explains). The
  97.                            SFFILE.BAT should contain:
  98.  
  99.                            COPY SFFILE.DAT D:\SFSFCOM
  100.                            D:
  101.                            CD\SFSFCOM
  102.                            SFSFCOM /CALLER
  103.  
  104.  
  105.                       To install from a door:
  106.                       -----------------------
  107.  
  108.                            Modify SF.BAT to include the following
  109.                            statements after the appropriate door
  110.                            "label".
  111.  
  112.                            COPY SFDOORS.DAT D:\SFSFCOM
  113.                            D:
  114.                            CD\SFSFCOM
  115.                            SFSFCOM /CALLER
  116.  
  117.  
  118.  
  119.  
  120.  
  121.             Step 4    That's it. The /CALLER parm says to "log" any
  122.                       downloads in the CALLERS.LOG file (same as
  123.                       Spitfire does). If you leave off /CALLER, it will
  124.                       write the data to a file called SFSF.LOG.
  125.  
  126.  
  127.  
  128.  
  129.                                      - Page 2 -
  130.  
  131. -------------------------------------------------------------------------------------
  132.                             SFSFCOM V3 from Bob Zimmerman
  133. -------------------------------------------------------------------------------------
  134.  
  135.  
  136.  
  137.  
  138.                       There are now 3 other parameters that may follow
  139.                       SFSFCOM. First is the word /NOLOG which eliminates
  140.                       the logging completely.
  141.  
  142.                       Next, /NOBATCH specifies you are running with a
  143.                       version of DSZ previous to 4/6/1988 (which is when
  144.                       the Zmodem batch support was added to DSZ).
  145.  
  146.                       Finally, /Wfile.ext specifies the location and
  147.                       name of a work file used when performing batch
  148.                       transfers. This file is about 100 bytes (that is
  149.                       right - extremely small) and is only created when
  150.                       doing batch transfers. The default is
  151.                       C:\FILES.$$$. If you do specify a file name, you
  152.                       MUST specify the Drive, followed by a colon,
  153.                       followed by a backslash, followed by the full path
  154.                       and file name. You must specify the WHOLE thing.
  155.  
  156.  
  157.             Step 5    You must run SFSFADD from the SFSFCOM directory.
  158.                       In other words, you should go to the D:\SFSFCOM
  159.                       directory first (using the CD command) and then
  160.                       begin SFSFADD.
  161.  
  162.                       Every time you want to "allow" a user to download
  163.                       a file, you simply run SFSFADD. This program will
  164.                       prompt you for the User Name, the File Name,
  165.                       whether the file should be deleted after it is
  166.                       downloaded, and a comment about the file.
  167.  
  168.                       THE FILE CAN BE ANYWHERE ON DISK - PREFERABLY NOT
  169.                       IN THE SPITFIRE FILE AREAS! This will prevent
  170.                       anyone but the authorized user from downloading
  171.                       it.
  172.  
  173.                       When running SFSFADD, you may use the "?" in the
  174.                       User Name and File Name to get help. I RECOMMEND
  175.                       YOU TRY BOTH OF THESE FEATURES AT LEAST ONCE!
  176.  
  177.  
  178.             Step 6    Make sure DSZ is installed anywhere in your PATH!
  179.  
  180.             Step 7    In your AUTOEXEC.BAT, add the line SET
  181.                       SFPATH=C:\SF where C:\SF is the path containing
  182.                       Spitfire.Exe.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                      - Page 3 -
  194.  
  195. -------------------------------------------------------------------------------------
  196.                             SFSFCOM V3 from Bob Zimmerman
  197. -------------------------------------------------------------------------------------
  198.  
  199.  
  200.  
  201.  
  202.  
  203.             Registration
  204.             ------------
  205.             All questions should be directed to:
  206.                                                Bob Zimmerman
  207.                                                Sysop - The Mainframe BBS
  208.                                                708-364-0425
  209.                                                9600/2400/1200/0300
  210.  
  211.  
  212.                                                The Mainframe
  213.                                                PO Box 1387
  214.                                                Arlington Heights, IL
  215.                                                60006
  216.  
  217.                                                MCI Mail:
  218.                                                R. Zimmerman 386-4706
  219.  
  220.                                                Compuserv 72371,1700
  221.  
  222.             The  above   mailing  address   should  be   used  for   the
  223.             registration   fee.   For   the   current   version   (1.0),
  224.             registration is  $18.00. When  this is  received, a ZIP file
  225.             will be  created on  my BBS  and made  available for  you to
  226.             download. If  you want  me to  send you  the disk  and  this
  227.             manual printed, add $5 for 5 1/4 disk or $7 for 3 1/2 disk.
  228.  
  229.             If you prefer, your package can be delivered via EASYPLEX of
  230.             Compuserv. Registration  plus Easyplex delivery will cost an
  231.             additional $5.
  232.  
  233.             Registration will  get you a specially compiled version that
  234.             eliminates the  front "unregistered  copy" message  and will
  235.             also get  you full technical support and free upgrades until
  236.             a major revision (at least 3 updates free).
  237.  
  238.             You are granted 30 days to evaluate this program. After that
  239.             30 day  period, if  you  choose  to  continue  running  this
  240.             program, you must register the product!
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                                      - Page 4 -
  258.  
  259. -------------------------------------------------------------------------------------
  260.                             SFSFCOM V3 from Bob Zimmerman
  261. -------------------------------------------------------------------------------------
  262.  
  263.  
  264.  
  265.             Revision History
  266.             ----------------
  267.  
  268.  
  269.             Version 1.1    Fixed the program so it will work with
  270.                            SFMAIN.DAT, SFFILE.DAT SFMESS.DAT or
  271.                            SFDOORS.DAT. You were having to copy whatever
  272.                            file Spitfire made to SFDOORS.DAT. Now you
  273.                            don't have to anymore.
  274.  
  275.             Version 1.5    Yep - it jumped to 1.5. I have cleaned up a
  276.                            great deal performance wise and added some
  277.                            code that will check if the DSZ transfer
  278.                            completed ok. It no longer asks the user did
  279.                            he receive it ok... It simply checks DSZ
  280.                            return code. If it is equal to 0 (transfer
  281.                            worked), then it will delete teh SFSF.DAT
  282.                            record and if requested by SFSFADD, delete
  283.                            the file that was transfered.
  284.  
  285.                            SFSFADD has a new feature as well. It will
  286.                            automatically add a record to the message
  287.                            file telling the user there is a file
  288.                            waiting. You must specify the text of the
  289.                            message...
  290.  
  291.             Version 1.6    If you installed this utility without DSZ in
  292.                            your path, then it would not run and if you
  293.                            had any files for deletion, they were deleted
  294.                            after the user downloaded them.
  295.  
  296.                            Now, a message is displayed on the console
  297.                            telling you the file DSZ.COM could not be
  298.                            found (in the current SFSFCOM directory or
  299.                            anywhere in the path).
  300.  
  301.                            ALSO - MAJOR ADDITION TO SFSFADD and all my
  302.                            future programs... Use the
  303.  
  304.                            SET SFPATH=spitfire path
  305.  
  306.                            in your autoexec.bat file. This will tell all
  307.                            my utils where to find Spitfire.Exe and all
  308.                            of the user files etc...
  309.  
  310.                            When you run SFSFADD to add a record, it will
  311.                            first search for a command line parameter
  312.                            /PC:\SF where C:\SF is the spitfire path, if
  313.                            that is not found, it searches for a previous
  314.                            SET command (e.g. SET SFPATH=C:\SF), and
  315.                            finally, if all else fails, it prompts you
  316.                            for "where is the path?")...
  317.  
  318.  
  319.  
  320.  
  321.                                      - Page 5 -
  322.  
  323. -------------------------------------------------------------------------------------
  324.                             SFSFCOM V3 from Bob Zimmerman
  325. -------------------------------------------------------------------------------------
  326.  
  327.  
  328.  
  329.  
  330.                            This suggestion comes from Diana Lucas and is
  331.                            greatly appreciated!
  332.  
  333.             Version 1.7    SFSFCOM now supports batch downloads. If the
  334.                            user tries downloading using Zmodem or Ymodem
  335.                            batch, and he has more then one file waiting,
  336.                            he will be given the option of downloading
  337.                            all the files in a "batch" at one time.
  338.  
  339.                            If at any time any of the files fail to
  340.                            download, the whole batch is considered "NOT
  341.                            DOWNLOADED" and the files remain in the users
  342.                            queue. He may use option 2 to remove the
  343.                            files he has successfully received.
  344.  
  345.  
  346.             Version 1.8    This version only modifies this
  347.                            documentation. Someone brought to my
  348.                            attention that the installation instructions
  349.                            really "sucked". Well, when I blow it, I do
  350.                            it well (or lousy depending on your
  351.                            perspective).
  352.  
  353.                            V1.8 basically has the installation
  354.                            instructions redone. They may be found in
  355.                            this doc. The program itself has not been
  356.                            changed.
  357.  
  358.  
  359.             Version 1.9    SFSFADD has been update to work with Spitfire
  360.                            2.8 and on. This is the only change. It will
  361.                            not work with previous versions of Spitfire.
  362.  
  363.                            It will add the message to a user in Message
  364.                            Conference #1 only.
  365.  
  366.                            If you have a default message you would like
  367.                            to send the user, you may use an environment
  368.                            variable of
  369.  
  370.                            SET SFSFADD = <whatever message you want>
  371.  
  372.                            Be careful, as your environment space may be
  373.                            running out and this could cause problems
  374.                            with Zmodem execution etc...
  375.  
  376.  
  377.             Version 1.91   the keyword /UPDATE_DL will have SFSFCOM
  378.                            update the callers statistics...
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.                                      - Page 6 -
  386.  
  387. -------------------------------------------------------------------------------------
  388.                             SFSFCOM V3 from Bob Zimmerman
  389. -------------------------------------------------------------------------------------
  390.  
  391.  
  392.  
  393.             Version 3.0    Updated the source for Spitfire 3.0. No
  394.                            longer requires the SFSYSDAT file, and
  395.                            supports file locking and sharing.
  396.  
  397.                            When building a batch download, the DSZ
  398.                            internal file for batch downloads now has the
  399.                            node number appended to it so that multiple
  400.                            nodes can run this door at the same time.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.                                      - Page 7 -